home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Amiga Public Domain Connection / APDC Disk #025 - Programming Languages (198x)(Amiga Public Domain Connection)(US)[m][WB].zip / APDC Disk #025 - Programming Languages (198x)(Amiga Public Domain Connection)(US)[m][WB].adf / Modula-2 / Readme.Dok
Text File  |  1988-03-15  |  4KB  |  118 lines
  1.  
  2. Files needed to use Modula-2:
  3. -----------------------------
  4.  
  5. The most important file is "ALoad" which is in the c: directory. This loader
  6. enables you to run programs compiled by the Modula-2 compiler.
  7. This program will be started by the startup-sequence included on this disk.
  8. The compiler makes all file references to files on a medium M2:, normally
  9. you assign the m2 directory as this medium.
  10.  
  11. 1>assign m2: AmigaLibDisk24:Modula-2/m2
  12.  
  13. In the m2 directory you find the compiler. It is divided into 10 modules, all
  14. named M4xM.OBM. The main module is M4PM.OBM. You will find also some other
  15. modules. The compiler itself needs AMIGABase, AMIGADOS, Clock, FileSystem,
  16. System, Terminal and TerminalBase. Without these the compiler will not run.
  17. The other modules give access to some Amiga libraries, but they are not
  18. complete and are included, together with some demo programs, to give you
  19. an idea what is possible with this system.
  20.  
  21. Use of Modula-2:
  22. ----------------
  23.  
  24. Before you use this Modula system, you should copy all files to your favorite
  25. CLI or Workbench disk.
  26.  
  27. As explained before, you can use modula programs only through the ALoad
  28. program. This program prompts you for a program name. Let's assume
  29. you want to start the compiler:
  30.  
  31. At the prompt you type M4PM (attention, the loader is case sensitiv):
  32.  
  33.     *M4PM
  34.  
  35. Aload will now load all the modules and display for each module a line:
  36.  
  37. f - M2:Terminal.OBM
  38. f - M2:FileSystem.OBM
  39.   ...
  40.  
  41. After all needed modules are loaded, the program will be started. The compiler
  42. will prompt you for the name of a module you want to compile, e.g. HelloWorld:
  43.  
  44. MC68000 Modula-2 Compiler V-2.0
  45. ETH Zuerich, IFI NW/HS/WH, 28.1.86
  46. in> HelloWorld.MOD
  47.  
  48. The compiler will now compile your program and output a line for each Module 
  49. imported, as well as for the Modules it generates:
  50.  
  51.  - M2:Terminal.SBM
  52.  - M2:AmigaDos.SBM
  53.  - M2:AmigaBase.SBM
  54.  + M2:HelloWorld.RFM
  55.  + M2:HelloWorld.OBM 1346
  56. in> 
  57.  
  58. As you see, the program needed the modules Terminal, AmigaDos and AmigaBase.
  59. The suffix .SBM denotes compiled definition modules. The compiler produced two
  60. files: HelloWorld.RFM and HelloWorld.OBM. The first file contains coded
  61. information for debugging. Unfortunatly we couldn't include the debugger,
  62. because it was not possible to port it to the Amiga yet. The second file
  63. contains the code. If the program had some errors, you would get a slightly 
  64. different output:
  65.  
  66.  - M2:Terminal.SBM
  67.  - M2:AmigaDos.SBM
  68.  - M2:AmigaBase.SBM
  69.  + M2:HelloWorld.RFM errors detected
  70. in>
  71.  
  72. You must now leave the compiler by pressing the ESCape key. You will get a
  73. message:
  74.  
  75. Back in C, press any key
  76.  
  77. and you will hear your Amiga writeing something to disk, the error listing.
  78. It is written on a file called M2:err.LST. But let's now assume your program
  79. does not have errors. 
  80.  
  81. After pressing a key you will see the ALoad prompt again and you can 
  82. start the compiled program by typing it's name:
  83.  
  84. *HelloWorld
  85.  
  86. You can leave ALoad by typing [CTRL-@] [RETURN] at the prompt.
  87.  
  88. WARNING: Do not compile any of the following files, otherwise you will no more
  89.      be able to run any program that uses these modules.
  90.  
  91.             AmigaBase.DEF
  92.         AmigaDos.DEF
  93.         Clock.DEF
  94.         FileSystem.DEF
  95.         System.DEF
  96.         Terminal.DEF
  97.         TerminalBase.DEF       
  98.  
  99. We included this definition modules, so that you can see what procedures they
  100. export. 
  101.  
  102. -------------------------------------------------------------------------------
  103.  
  104. If you have any problems or questions contact us:
  105.  
  106. Electronic-Mail:
  107.  
  108. UUCP:   ...seismo!mcvax!cernvax!ethz!claudio
  109. BITNET: K538912@CZHRZU1A
  110. EAN:    claudio@ifi.ethz.chunet
  111.  
  112. Paper-Mail:
  113.  
  114.    Claudio Nieder
  115.    Kanalweg 1
  116.  
  117. CH-8610 Uster   Switzerland
  118.